home *** CD-ROM | disk | FTP | other *** search
/ MacHome 2000 May / MacHome CD (May 2000).iso / Games / MacMESS_.36b15.sit / MacMESS .36b15 / Documentation / MESS_OLD.TXT < prev    next >
Encoding:
Text File  |  2000-01-30  |  29.1 KB  |  913 lines  |  [TEXT/ttxt]
  1. NOTE:
  2.  
  3. This information is being transferred to SYSINFO.DAT, and will be available from the 
  4. MESS UI, accessable from the Machine History entry.  The information in sysinfo.dat 
  5. will also be able to be viewed offline in html format.
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15. ====================================
  16. Supported Systems and Related Issues
  17. ====================================
  18.  
  19.  
  20. a5200 - Atari 5200:
  21. -------------------
  22. Known Issues:
  23.      - This driver is preliminary.  You can see the Atari system loadup screen,
  24.        and a ROM will start, but the emulated system hangs...  If you can supply 
  25.        info, please contact the MESS team! ;-)
  26.  
  27.      - Required System ROM (5200sys.bin - 2,048k - CRC 4248d3e3) - the system 
  28.        will not run without it.
  29.  
  30.  
  31. Compatibility:
  32.      - This driver is preliminary and won't run past the demo screen.  
  33.        Help is needed.
  34.  
  35.  
  36.  
  37.  
  38.  
  39. a7800 - Atari 7800:
  40. -------------------
  41. Known Issues:
  42.      - This system requires the SYSTEM BIOS to enable it to work.  To see what 
  43.        file is required, type:
  44.           MESS a7800 -listroms
  45.  
  46. Usage:
  47.      - "R"  = Reset
  48.      - "S"  = Select
  49.      - Ctrl = Button 1
  50.      - Alt  = Button 2
  51.  
  52. Compatibility:
  53.      - Runs most games well.
  54.  
  55.  
  56.     
  57.  
  58.  
  59.  
  60. -----------------
  61. a800 - Atari 800:
  62. -----------------
  63. Known Issues:
  64.      - Requires full keyboard emulation.  At startup, full keyboard emulation 
  65.        mode is enabled by default.  Whilst in full keyboard emulation mode, 
  66.        some key associated functionality may be disabled (like the ESC key for 
  67.        EXIT).  The keyboard emulation mode is toggled using the scroll_lock key.   
  68.  
  69.      - Required System ROM (atariosb.rom - 1024 bytes  3e28a1fe)  
  70.  
  71.      - The Atari800 driver now has two ROM slots. It really had two 
  72.        slots, so I modified the code to optionally read the second 
  73.        part of a 16K ROM from the second cartridge filename provided 
  74.        (right slot).
  75.        The previous version had a800_cartridge_32k flag which was      
  76.        wrong.  Cartridges are either 8K or 16K, so I renamed that to
  77.        ..._16k too ;)
  78.  
  79. Compatibility:
  80.      - It should run just about anything you throw at it.
  81.     
  82.  
  83.  
  84.  
  85.  
  86.  
  87. ------------------------
  88. amiga - Commodore Amiga:
  89. ------------------------
  90. Known Issues:
  91.      - NOT WORKING.  Problems introduced during the conversion to the 
  92.        new MAME core :(   System begins to boot, but eventually hangs.
  93.  
  94.  
  95.  
  96. ----------------------
  97. amstrad - CPC Amstrad:
  98. ----------------------
  99. Known Issues:
  100.      - Requires full keyboard emulation.  At startup, full keyboard emulation 
  101.        mode is enabled by default.  Whilst in full keyboard emulation mode, 
  102.        some key associated functionality may be disabled (like the ESC key for 
  103.        EXIT).  The keyboard emulation mode is toggled using the scroll_lock key.   
  104.  
  105.      - This system requires the SYSTEM BIOS to enable it to work.  To see what 
  106.        file is required, type:
  107.           MESS amstrad -listroms
  108.  
  109. Compatibility:
  110.      - This driver is considered preliminary.  The system ROM is loaded, and the 
  111.        Amstrad screen is shown.  Image loading is not supported yet.
  112.  
  113.  
  114.  
  115. ----------------------
  116. apl2cpls - APPLE DRIVERS
  117. apple2c  -
  118. apple2c0 -
  119. apple2e  -
  120. apple2ee -
  121. apple2ep -
  122. ----------------------
  123. Known Issues:
  124.      - Requires full keyboard emulation.  At startup, full keyboard emulation 
  125.        mode is enabled by default.  Whilst in full keyboard emulation mode, 
  126.        some key associated functionality may be disabled (like the ESC key for 
  127.        EXIT).  The keyboard emulation mode is toggled using the scroll_lock key.   
  128.  
  129.      - Keyboard problems with the conversion to the MAME core....  These systems 
  130.        work ok, but not much happens due to the keyboard problems...  You need 
  131.        the system ROMS to run these...   
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138. ---------------------
  139. astrocde - Astrocade:
  140. ---------------------
  141. Compatibility:
  142.     It should run just about anything you throw at it.
  143.  
  144.  
  145.  
  146. ------------------------------------
  147. c16    commodore c16 (pal version)
  148. plus4    commodore plus4 (ntsc version)
  149. ------------------------------------
  150. (beta version)
  151.  
  152. if the game runs to fast with the ntsc version, try the pal version!
  153.  
  154. status
  155. ------
  156. (hardware softscrolling vertical?)
  157. (imperfect colors)
  158. imperfect sound (noise channel complete wrong)
  159. simple tape support
  160. no serial bus support (disk drives/printer)
  161. no rs232 (plus4)
  162.  
  163. no special expansion modules
  164.  simple iec support (c1551 floppy disk drive)
  165.  
  166. some unsolved problems
  167.  
  168.  memory check by c16 kernel will not recognize more memory without
  169. restart of mess
  170.  cpu clock switching/changing
  171.  
  172. Keys
  173. ----
  174. Some PC-Keyboards does not behave well when special two or more keys are
  175. pressed at the same time
  176. (with my keyboard printscreen clears the pressed pause key!)
  177.  
  178. shift-cbm switches between upper-only and normal character set
  179. (when wrong characters on screen this can help)
  180.  
  181. Tape
  182. ----
  183. loading of wav, prg and prg files in zip archiv
  184. commandline cassette=image
  185. wav:
  186.  8 or 16(not tested), 5000 Hz minimum
  187.  has the same problems like an original tape drive (tone head must
  188.  be adjusted to get working(no load error,...) wav-files)
  189. zip:
  190.  must be placed in current directory
  191.  prg's are played in the order of the files in zip file
  192. must be 1st romname in commandline
  193. use load or load"" or load"",1 for loading of normal programs
  194. use load"",1,1 for loading programs to their special address
  195.  
  196. Discs
  197. -----
  198. only file load from drive 8 and 9 implemented
  199.  loads file from rom directory (*.prg)
  200.  or file from d64 image (here also directory supported)
  201. use dload"filename"
  202. or load"filename",8
  203. or load"filename",8,1 (for loading machine language programs at their
  204. address)
  205. for loading
  206. type run or the appropriate sys call to start them
  207.  
  208. Roms
  209. ----
  210. .bin .rom .lo .hi .prg
  211. files with boot-sign in it
  212.   recogniced as roms
  213.  
  214. .prg files loaded at address in its first two bytes
  215. .bin, .rom, .lo , .hi roms loaded to cs1 low, cs1 high, cs2 low, cs2
  216. high
  217.  address accordingly to order in command line
  218.  
  219. when problems start with -log and look into error.log file
  220.  
  221.  
  222.  
  223.  
  224. ----------------------    
  225. cgenie - Colour Genie:
  226. ----------------------
  227. Known Issues:
  228.      - Requires full keyboard emulation.  At startup, full keyboard emulation 
  229.        mode is enabled by default.  Whilst in full keyboard emulation mode, 
  230.        some key associated functionality may be disabled (like the ESC key for 
  231.        EXIT).  The keyboard emulation mode is toggled using the scroll_lock key.   
  232.  
  233. Usage:
  234.     keyboard - relatively close to the original layout.
  235.     joystick - emulation of dual Colour Genie joysticks with keypads.
  236.     cassette - emulation of virtual tapes supported.
  237.         Use SYSTEM or CLOAD commands to read images.
  238.         SYSTEM supports 6 character filenames, CLOAD loads
  239.         a file named BASIC[N].CAS, where [N] is the character
  240.         you supplied (e.g. CLOAD"M" loads BASICM.CAS)
  241.     floppies - emulation of virtual floppy discs supported.
  242.         Use CMD"I0" to "CMDI3" to get an inventory of drive 0 to 3,
  243.         use CMD"S FILENAME/CMD" to start a binary executable or use
  244.         LOAD"FILENAME/BAS" to load a basic program.
  245.  
  246. Options:
  247. Under the "Options" menu, accessible by hitting TAB, there are three settings.
  248.     "Floppy Disc Drives"  - enable or disable floppy disc controller.
  249.     "DOS ROM C000-DFFF"   - enable 8K DOS ROM or make it RAM.
  250.     "EXT ROM E000-EFFF"   - enable 4K Extension ROM or make it RAM.
  251.  
  252. Compatibility:
  253.     The Colour Genie driver should run most of the known programs out there.
  254.     It supports the Motorola 6845 CRT controller with text and graphics
  255.     modes (LGR and FGR), the AY-3-8910 sound chip with three audio channels
  256.     and noise and the WD 179x floppy disc controller with up to four
  257.     virtual floppy disc drives contained in image files.
  258.  
  259. Known issues:
  260.     Startup with CAS or CMD images does not always work. Use the BASIC
  261.     SYSTEM or CLOAD commands to read cassette image files, or use
  262.     the Colour Genie DOS ROM with floppy disc images to run programs.
  263.     The driver does not yet emulate the printer port mode for AY-3-8910.
  264.     Right now it always uses the AY-3-8910 ports for joystick emulation.
  265.  
  266. Notes:
  267. The Colour Genie driver requires the presence of the following images:
  268.     CGENIE.ROM      16K Basic and BIOS.
  269.     CGENIE1.FNT     8x8 default character set with graphics.
  270. To access the virtual floppy disc capabilities you need:
  271.     CGDOS.ROM       8K Disk Operation System.
  272. And as an add-on "DOS Interface" you can use:
  273.     NEWE000.ROM     4K Extension
  274.     
  275.  
  276.  
  277. Additional info:
  278.     Specify the disk image on the mess commandline.
  279.         mess cgenie games1.dsk
  280.         
  281.     The newe000.rom is loaded if the corresponding "dip switch" is set 
  282.     from the driver itself. No need to specify any roms on the commandline.
  283.     
  284.     Inside the emulation type:
  285.         cmd"i
  286.     to list the contents of the floppy disk image.
  287.     To start a game, eg. paint/cmd, type
  288.         cmd"s paint/cmd
  289.     
  290.     You can omit the blank between cmd"s and the filename..................
  291.     
  292.     
  293.     This is how it also works:
  294.         mess cgenie games1.dsk games2.dsk games3.dsk games4.dsk
  295.  
  296.     CLOAD is for BASIC type tapes only.  It should work if you have a 
  297.     BASIC *.cas file. File "names" in that case are _one_ character in 
  298.     length (inside the emulation).  In your roms/cgenie folder the 
  299.     names will be basicA.cas, basicB.cas and so on.  If you CSAVE"A 
  300.     you'll see a file basicA.cas laterand you can CLOAD"A it again. 
  301.     
  302.     To load a binary image there was a different command:
  303.         SYSTEM
  304.     You'll see a prompt looking like this:
  305.         *?
  306.     and there you can enter a name of up to six (wow!) characters.
  307.         *?chop16<ENTER>
  308.     will start loading a file named chop16.cas if it is in your rompath.
  309.     If you don't have it... well, wait and see (nothing ;)  If you have 
  310.     it, you'll see two stars (**) in the upper right corner.  The right 
  311.     one will twinkle after every couple of bytes loaded, every 254 I 
  312.     think.
  313.     
  314.     After several minutes you'll see the prompt again
  315.         *?
  316.     now type / (slash) and ENTER and the program will be started at it's
  317.     defined run address. If a program does not have a run address, you 
  318.     could also specify /<decimal value> to run from a specific value...
  319.  
  320.     Also,.....
  321.     Tap <ENTER> and also confirm the following 
  322.     MEM SIZE?
  323.     with <ENTER>.
  324.     After that you're in BASIC (DISK BASIC, to be exact, unless you disable 
  325.     cgdos.rom via the dip switches).
  326.  
  327.     Now you can use the DISK BASIC extensions to issue commands.  Most important
  328.     CMD"I<disk#>    display inventory, disk# is optional and can be from 0 to 3
  329.     CMD"Sname/cmd    start a binary file name/cmd from any disk
  330.     CMD"Limage/bin:3    load image/bin from disk 3
  331.  
  332.     To ease things you could also enbale my DOS lookalike frontend ;)
  333.     It's contained in newE000.rom but not enabled by default.
  334.     If you enable it you can type HELP (hehe ;) and DIR and simply
  335.     give a name to execute a binary file.
  336.  
  337.  
  338.  
  339.  
  340.     
  341. ---------------------
  342. coco - Color Computer:
  343. ---------------------
  344. Known Issues:
  345.      - Requires full keyboard emulation.  At startup, full keyboard emulation 
  346.        mode is enabled by default.  Whilst in full keyboard emulation mode, 
  347.        some key associated functionality may be disabled (like the ESC key for 
  348.        EXIT).  The keyboard emulation mode is toggled using the scroll_lock key.   
  349.  
  350.  
  351.  
  352.     
  353. ----------------------
  354. coleco - ColecoVision:
  355. ----------------------
  356. Usage:
  357.     arrow keys - 1p move
  358.     ctrl, alt - 1p fire
  359.     1-0 - number keys on the Colecovision controller
  360.     minus - '#' key on the Colecovision controller
  361.     equals - '.' key on the Colecovision controller
  362.  
  363. Compatibility:
  364.     To the best of my knowledge, this emulation should run any cartridge
  365.     accurately.
  366.  
  367. Notes:
  368.     The Colecovision driver requires the presence of "COLECO.ROM".  The driver
  369.     will not function without this ROM.  A real Colecovision also will not
  370.     function without this ROM.
  371.  
  372. Thanks:
  373.     Special thanks to Marat Fayzullin for providing loads of Colecovision
  374.     information through the ColEm source.
  375.  
  376.  
  377.  
  378.  
  379.  
  380. --------------------
  381. dragon32 - Dragon32:
  382. --------------------
  383. Known Issues:
  384.      - Requires full keyboard emulation.  At startup, full keyboard emulation 
  385.        mode is enabled by default.  Whilst in full keyboard emulation mode, 
  386.        some key associated functionality may be disabled (like the ESC key for 
  387.        EXIT).  The keyboard emulation mode is toggled using the scroll_lock key.   
  388.  
  389.  
  390.  
  391. -----------------------
  392. ep128 - Enterprise 128:
  393. -----------------------
  394. Known Issues:
  395.      - Requires full keyboard emulation.  At startup, full keyboard emulation 
  396.        mode is enabled by default.  Whilst in full keyboard emulation mode, 
  397.        some key associated functionality may be disabled (like the ESC key for 
  398.        EXIT).  The keyboard emulation mode is toggled using the scroll_lock key.   
  399.  
  400.      - This system requires the SYSTEM BIOS to enable it to work.  To see what 
  401.        file is required, type:
  402.           MESS ep128 -listroms
  403.  
  404. Compatibility:
  405.      - This driver is considered preliminary.  The system ROM is loaded, and the 
  406.        Enterprise screen is shown.  Image loading is not supported yet.
  407.  
  408.  
  409.  
  410. -------------------------
  411. gamegear - Sega GameGear:
  412. -------------------------
  413.      - See Sega Master System.
  414.  
  415.  
  416.  
  417. ----------------------------------------------
  418. genesis - Genesis (MegaDrive in Japan/Europe):
  419. ----------------------------------------------
  420. Usage:
  421.     arrow keys - 1p move
  422.     control, alt - 1p fire
  423.     1,2 - 1, 2 player select
  424.     return - 1p start
  425.  
  426. Options:
  427.     Under the "Options" menu, accessible by hitting TAB, you will find the
  428.     following option:
  429.  
  430.     "Country" - this allows you to alter the 'flavour' of Genesis, to either European,
  431.                 Japanese or American. Many cartridges compare their country codes with
  432.                 that of the Genesis itself and may behave differently, or lock up if the
  433.                 two types do not match.
  434.                 'Auto' attempts to auto-set the Genesis country code to the value the
  435.                 cartridge will appear to be checking for. This may not be 100% accurate,
  436.                 however.
  437.  
  438. Compatibility:
  439.     Most games tend to run fairly well. some with slight graphic glitches, incorrect
  440.     colours part way down the screen or other b'zarre effects.
  441.  
  442.     Cartridges up to 32MBit (4MByte) are supported.
  443.  
  444.     The controller may not work well with some games. This will be resolved when I
  445.     obtain more information. Similarly, 6-button joypads aren't emulated yet.
  446.  
  447.     Split screen effects and interlacing are not yet supported.
  448.  
  449.     Sprite/layer priority should be perfect.
  450.  
  451.     Sound is emulated at Z80 and PSG76489 level. There is no inbuilt YM2612 support,
  452.     this will follow on soon using software FM synthesis.  
  453.  
  454. Notes:
  455.     I still consider the Genesis driver extremely preliminary. I have a lot of further
  456.     work to do before I consider it anywhere near complete. My initial goal is to make
  457.     it as compatible as possible. Currently there is scope within the driver to handle
  458.     split screen colour changes/any VDP effect, interlacing, without rewriting. The
  459.     graphics renderer emulates VDP at scanline level, and does not use tile-based
  460.     methods.
  461.     
  462. Wanted:
  463.     Any Sega Megadrive information! Information is extremely sparse; typically the same
  464.     three-four documents, with parts incomplete, conflicting, and corrupted. Specifically,
  465.     some of the finer points of DMA transfer, and access of the 68K memory map by the Z80.
  466.     Generally, points which conflict with themselves in the documentation available on
  467.     the net...
  468.  
  469. Thanks:
  470.     ...which I'm thankful for, as there certainly isn't any source available to look at!
  471.     Thanks to the rest of the MESS team, Terence & Philip and the MAME team, Kevin Lingley
  472.     for support and ex(p|t)ensive games testing in this driver's ARM code & early forms,
  473.     and, of course, Stan, Kyle, Eric, Kenny...
  474.     
  475.     Please note that no goats were sacrificed during the development of this driver. 
  476.  
  477.  
  478.  
  479.  
  480. ----------------
  481. kaypro - Kaypro:
  482. ----------------
  483. Known Issues:
  484.      - Requires full keyboard emulation.  At startup, full keyboard emulation 
  485.        mode is enabled by default.  Whilst in full keyboard emulation mode, 
  486.        some key associated functionality may be disabled (like the ESC key for 
  487.        EXIT).  The keyboard emulation mode is toggled using the scroll_lock key.   
  488.  
  489.      - Problems with the conversion to the MAME core....  Emulation OK....  
  490.  
  491.  
  492.  
  493.  
  494. --------------------
  495. kccomp - KC Compact:
  496. --------------------
  497. Known Issues:
  498.      - Requires full keyboard emulation.  At startup, full keyboard emulation 
  499.        mode is enabled by default.  Whilst in full keyboard emulation mode, 
  500.        some key associated functionality may be disabled (like the ESC key for 
  501.        EXIT).  The keyboard emulation mode is toggled using the scroll_lock key.   
  502.  
  503.      - This system requires the SYSTEM BIOS to enable it to work.  To see what 
  504.        file is required, type:
  505.           MESS kccomp -listroms
  506.  
  507. Compatibility:
  508.      - This driver is considered preliminary.  The system ROM is loaded, and the 
  509.        KC compact screen is shown.  Image loading is not supported yet.
  510.  
  511.  
  512.  
  513.  
  514. ------------
  515. kim1 - KIM-1
  516. ------------
  517. Compatibility:
  518.      - This driver supports the backdrop image of the KIM-1.
  519.  
  520. Description:
  521. A 'Lunar Lander' game is currently hardcoded into kim1_init_machine() ;-)
  522. It is in memory from 0200 to 02DA. To start it just enter
  523. [0] [2] [0] [0] and [F5] afterwards (GO).
  524.  
  525. /*
  526.  * LUNAR LANDER
  527.  *   Jim Butterfield
  528.  *
  529.  * Description
  530.  *      This program starts at 0200.  When started, you will find
  531.  * yourself at 4500 feet and falling.  The thrust on your machine
  532.  * is set to low; so you will pick up speed due to the force of
  533.  * gravity.
  534.  *     You can look at your fuel at any time by pressing the
  535.  * "F" button.  Your fuel (initially 800 pounds) will be shown
  536.  * in the first four digits of the KIM display.
  537.  *     The last two digits of the KIM display always show
  538.  * your rate of ascent of descent.  "A" restores altitude.
  539.  *     Set your thrust by pressing buttons 1 through 9.
  540.  * Warning: button 0 turns you motor off, and it will not
  541.  * reignite!  A thrust of 1, minimum, burns very little fuel;
  542.  * but gravity will be pulling your craft down faster and
  543.  * faster.  A thrust of 9, maximum, overcomes gravity
  544.  * and reduces your rate of descent very sharply  A thrust of 5
  545.  * exactly counterbalances gravity; you will continue to descend
  546.  * (or ascend) at a constant rate.  If you run out of fuel,
  547.  * your thrust controls will become inoperative.
  548.  *
  549.  * Suggestions for a safe flight:
  550.  *   [1] Conserve fuel at the beginning by pressing 1.  You
  551.  *       begin to pick up speed downwards.
  552.  *   [2] When your rate of descent gets up to the 90's, you're
  553.  *       falling fast enough.  Press 5 to steady the rate.
  554.  *   [3] When your altitude reaches about 1500 feet, you'll
  555.  *       need to slow down.  Press 9 and slow down fast.
  556.  *   [4] When your rate of descent has dropped to 15 or 20,
  557.  *       steady the craft by pressing 5 or 6.  Now you're on
  558.  *       your own.
  559.  */
  560.  
  561. It'd be interesting if the audio output of a save would be readable
  562. on a KIM-1 board. To listen to the hard-bit-rock ;) just type
  563. [F1] [1] [8] [0] [0] and [F5]
  564.  
  565. the keys:
  566. key    name    description
  567. -------------------------------------
  568. F1    AD    address mode
  569. F2    DA    data mode
  570. F3    RS    reset
  571. F5    GO    execute from address
  572. F6    PC    program counter (hmm.. whatever)
  573. F7    ST    step (does not yet work; NMI handling for K7 missing)
  574. ENTER    +    increase address
  575. 0-F    hex    hex digits
  576.  
  577.  
  578.  
  579. ------------------------------------
  580. nes - Nintendo Entertainment System:
  581. ------------------------------------
  582. Usage:
  583.     arrow keys - 1p move
  584.     control, alt - 1p fire
  585.     3 - Select
  586.     1,2 - 1, 2 player select
  587.     return - 1p start
  588.  
  589.     
  590. Options:
  591.     Under the "Options" menu, accessible by hitting TAB, are two settings.
  592.     "Renderer" - can be set to Scanline or Experimental. The Scanline renderer gives
  593.                  the most accurate display, but can be slow. The Experimental
  594.                  option is much faster, but still needs quite a bit of work before it
  595.                  displays properly in all cases. It's best used for games with no
  596.                  scrolling playfields, like Donkey Kong, etc.
  597.     "Split-Screen fix" - defaults to off. Turn it on to see proper split screens in
  598.                  games like Kirby's Adventure and Airwolf. This will most likely go
  599.                  away in the future as we figure out how these split screens really work.
  600.  
  601. Compatibility:
  602.     The NES driver should run 99% of the ROMs currently out there with very little problem.
  603.     It doesn't yet support a lot of the obscure mappers used in fwNES, but this is on deck
  604.     for the next release. For the record, it supports mappers 1, 2, 3, 4, 5 (incomplete),
  605.     7, 8, 9 & 10 (incomplete), 11, 15, 16, 18 (vrom probs), 25 (vrom probs), 33, 34,
  606.     64, 65, 66, 68 (incomplete), 69 (incomplete), 71, 78, 79.
  607.     Some of the mappers > 63 haven't been fully tested yet.
  608.     
  609. Notes:
  610.     The main focus up until this point has been in getting the NES driver as accurate
  611.     as possible. Unfortunately, the scanline rendering method is quite slow, so future
  612.     efforts will be focusing on bringing up the speed. Also, the sound code is still a
  613.     bit shaky. However, the NES driver does have quite accurate sample playback. For example,
  614.     you can hear speech samples in Bayou Billy, Gauntlet, Dirty Harry, and Skate or Die
  615.     that are not present in a few other NES emulators.
  616.     
  617. Wanted:
  618.     I'd appreciate any info on some of the more obscure mappers. If you have
  619.     any of this, please drop me a line at bradman@primenet.com.
  620.     
  621. Thanks:
  622.     Special thanks to Nicolas Hamel for xNES. Also, thanks to Marat Fayzullin, D,
  623.     Icer Addis, Matt Conte, Arthur Langereis, and John Stiles for tips and moral support 
  624.         during the development of the NES driver. And last but not least, thanks to Jeremy 
  625.         Chadwick and Firebug for their respective NES docs, without which this driver would 
  626.         have taken considerably longer. I'll be sending you guys updates for both files 
  627.         soon. ;)
  628.  
  629.  
  630.  
  631.  
  632. -------------------------------------
  633. oric1     "Oric 1"
  634. orica     "Oric Atmos"
  635. -------------------------------------
  636.  
  637.  
  638.  
  639.  
  640.  
  641. -------------------------------------
  642. pccga     "IBM PC/XT - CGA"
  643. pcmda     "IBM PC/XT - MDA"
  644. -------------------------------------
  645.  
  646.  
  647.  
  648.  
  649. ------------------------
  650. pce - PC Engine/TurboGfx
  651. ------------------------
  652.      - Preliminary...  Xevious and Raiden8x work OK.
  653.  
  654.  
  655. ---------------------------
  656. pdp1      "pdp1 SPACEWAR!"
  657. ---------------------------
  658.      - Currently emulates one image - SPACEWAR!
  659.  
  660.  
  661. ----------------------------
  662. raaspec   "RA+A Spectrum I+"
  663. ----------------------------
  664. Intro:
  665.      - The Spectrum I+ was a modified Vectrex. It had a 32K ROM cart and 2K additional 
  666.        battery backed RAM (0x8000 - 0x87ff). PB6 was used to signal inserted coins to 
  667.        the VIA. The unit was controlled by 8 buttons (2x4 buttons of controller 1 and 
  668.        2).  Each button had a LED which were mapped to 0xa000.  The srvice mode can 
  669.        be accessed by pressing button 8 during startup.  As soon as all LEDs light up, 
  670.        press 2 and 3 without releasing 8. Then release 8 and after that 2 and 3. You 
  671.        can leave the screen where you enter ads by pressing 8 several times.
  672.  
  673. Usage:
  674.      - This is the list of the ROMs required for driver "raaspec".
  675.        Name              Size       Checksum
  676.        spectrum.bin    32768 bytes  20af7f3f
  677.        system.img       8192 bytes  ba13fb57
  678.  
  679.      - For the 8-button key mappings, see the user menu under 
  680.        "Keys (This Machine)".
  681.  
  682. Compatibility:
  683.      - This driver supports the LED backdrop images:
  684.          spec_bt.png
  685.      led.png
  686.  
  687.  
  688.  
  689.  
  690. -----------------------
  691. sms - Sega MasterSystem
  692. -----------------------
  693. Usage:
  694.     arrow keys - 1p move
  695.     control, alt - 1p fire
  696.     1,2 - 1, 2 player select
  697.     return - 1p start
  698.     
  699. Compatibility:
  700.     It's not very compatible right now. The code is still quite preliminary. It should run
  701.     most of the ROMs, but quite a few exhibit graphics glitches. The MasterSystem has
  702.     totally incorrect color also. Sound emulation appears to be near perfect though.
  703.     
  704. Wanted:
  705.     We'd like some spare time to work on this. Care to donate any? :)
  706.     
  707. Thanks:
  708.     Thanks to Marat Fayzullin for his MasterGear emulation.
  709.  
  710.  
  711.  
  712.  
  713.  
  714. ----------------------------
  715. spectrum - Sinclair Specrum:
  716. ----------------------------
  717. Known Issues:
  718.      - Requires full keyboard emulation.  At startup, full keyboard emulation 
  719.        mode is enabled by default.  Whilst in full keyboard emulation mode, 
  720.        some key associated functionality may be disabled (like the ESC key for 
  721.        EXIT).  The keyboard emulation mode is toggled using the scroll_lock key.   
  722.  
  723.      - This system requires the SYSTEM BIOS to enable it to work.  To see what 
  724.        file is required, type:
  725.           MESS spectrum -listroms
  726.  
  727. Compatibility:
  728.      - This driver is considered preliminary.  The system ROM is loaded, and the 
  729.        Spectrum screen is shown.
  730.  
  731.  
  732.  
  733.  
  734.  
  735. --------------------------------
  736. ti99      "TI99/4A Home Computer
  737. --------------------------------
  738. Known Issues:
  739.      - Requires full keyboard emulation.  At startup, full keyboard emulation 
  740.        mode is enabled by default.  Whilst in full keyboard emulation mode, 
  741.        some key associated functionality may be disabled (like the ESC key for 
  742.        EXIT).  The keyboard emulation mode is toggled using the scroll_lock key.   
  743.  
  744.      - The system does not work due to keyboard problems.
  745.  
  746.  
  747.  
  748.  
  749.  
  750. ----------------------
  751. trs80 - TRS-80 Model I
  752. ----------------------
  753. Usage:
  754.     keyboard - relatively close to the original layout.
  755.         Take a look into the "Options" menu, accessible by hitting
  756.         TAB, and choose "Keyboard Setup" to find out more about
  757.         the key mapping - changing is not yet supported.
  758.     cassette - emulation of virtual tapes supported.
  759.         Use SYSTEM or CLOAD commands to read images.
  760.         SYSTEM supports 6 character filenames and loads the
  761.         corresponding FILENM.CAS image, CLOAD loads a file named
  762.         BASIC[N].CAS, where [N] is the character you supplied
  763.         (e.g. CLOAD"M" loads BASICM.CAS)
  764.     floppies - emulation of virtual floppy discs supported.
  765.         Use a NEWDOS/80 boot disk for drive 0 and set up correct
  766.         PDRIVE parameters for the other drives.
  767.         If only drives 0 to 2 are used they can be double sided
  768.         by interpreting drive select 3 as head select bit.
  769.  
  770. Options:
  771. Under the "Options" menu, accessible by hitting TAB, there are three settings.
  772.     "Floppy Disc Drives"  - enable or disable floppy disc controller.
  773.     "Video RAM"           - enable upper case only or upper/lower font.
  774.     "Virtual E000-EFFF"   - enable 4K Extension ROM or make it RAM.
  775.  
  776. Compatibility:
  777.     The TRS-80 driver should run most of the known programs out there.
  778.     It supports a WD 179x floppy disc controller with up to four
  779.     virtual floppy disc drives contained in image files.
  780.  
  781. Notes:
  782. The TRS-80 driver requires the presence of the following images:
  783.     TRS80.ROM       12K Level II Basic.
  784.     TRS80.FNT       6x15 default character set with block graphics.
  785.  
  786.  
  787.  
  788.  
  789. ------------------
  790. vectrex - Vectrex:
  791. ------------------
  792. Usage:
  793.  
  794. Compatibility:
  795.     To the best of our knowledge, this emulation should run most cartridges
  796.     accurately.
  797.  
  798. Notes:
  799.     The Vectrex driver requires the presence of "SYSTEM.IMG".  The driver
  800.     will not function without this ROM.  A real Vectrex also will not
  801.     function without this ROM. Also, overlay support is present now!
  802.  
  803. Thanks:
  804.     Special thanks to Keith Wilkins and Chris Salomon for their work on DVE
  805.     and their help,    without which this driver would have taken much longer.
  806.  
  807.  
  808.  
  809.  
  810. ------------------------------------
  811. vic20 commodore vic20 (ntsc version)
  812. vc20  commodore vc20  (pal version)
  813. ------------------------------------
  814.  
  815. vic20 ntsc-version
  816.  when screen is two wide right or low, or screen doesn't fitt in visible
  817.  area try the pal version
  818.  
  819. vc20  pal-version
  820.  
  821. a normal or good written program does not depend on the video system
  822.  
  823. Status
  824. ------
  825.  
  826. imperfect sound (noise channel complete wrong)
  827.  simple tape support
  828.  no serial bus support (disks/printer)
  829.  no rs232
  830.  
  831. for a more complete vic20 emulation take a look at the very good
  832. vice emulator
  833.  
  834. Video
  835. -----
  836. NTSC:
  837. Screen Size (normal TV (horicontal),4/3 ratio)
  838. pixel ratio: about 7/5 !
  839. so no standard Vesa Resolution is good
  840. tweaked mode 256x256 acceptable
  841. best define own display mode (when graphic driver supports this)
  842. PAL:
  843. pixel ratio about 13/10 !
  844. good (but only part of screen filled) 1024x768
  845. acceptable 800x600
  846. better define own display mode (when graphic driver supports this)
  847.  
  848. XMESS:
  849. use -scalewidth 3 -scaleheight 2 for acceptable display
  850. better define own display mode
  851.  
  852. Keys
  853. ----
  854. Some PC-Keyboards does not behave well when special two or more keys are
  855. pressed at the same time
  856. (with my keyboard printscreen clears the pressed pause key!)
  857.  
  858. stop-restore in much cases prompt will appear
  859. shift-cbm switches between upper-only and normal character set
  860. (when wrong characters on screen this can help)
  861.  
  862. Lightpen
  863. --------
  864. Paddle 3 x-axe
  865. Paddle 4 y-axe
  866.  
  867. Tape
  868. ----
  869. loading of wav, prg and prg files in zip archiv
  870. commandline cassette=image
  871. wav:
  872.  8 or 16(not tested), 12500 Hz minimum
  873.  has the same problems like an original tape drive (tone head must
  874.  be adjusted to get working(no load error,...) wav-files)
  875. zip:
  876.  must be placed in current directory
  877.  prg's are played in the order of the files in zip file
  878.  
  879. must be 1st romname in commandline
  880. use load or load"" or load"",1 for loading of normal programs
  881. use load"",1,1 for loading programs to their special address
  882.  
  883. Roms
  884. ----
  885. .bin .rom .a0 .20 .40 .60 .prg
  886. files with boot-sign in it
  887.   recogniced as roms
  888.  
  889. .20 files loaded at 0x2000
  890. .40 files loaded at 0x4000
  891. .60 files loaded at 0x6000
  892. .a0 files loaded at 0xa000
  893. .prg files loaded at address in its first two bytes
  894. .bin .rom files loaded at 0x4000 when 0x4000 bytes long
  895. else loaded at 0xa000
  896.  
  897. when problems start with -log and look into error.log file
  898.  
  899.  
  900.  
  901.  
  902. ------
  903. vz200
  904. vz300
  905. ------
  906.  
  907. If a game doesn't start after a second, it's most probably a BASIC
  908. game and you have to type "RUN<ENTER>" ;)
  909. If it still doesn't run, there's a bug (in the image or the driver).
  910.  
  911.  
  912.  
  913.